home *** CD-ROM | disk | FTP | other *** search
/ APDL Eductation Resources / APDL Eductation Resources.iso / earthmap / _earthmap / docs / guide next >
Encoding:
Text File  |  1993-06-22  |  12.8 KB  |  338 lines
  1. >Guide
  2. _______________________________________________________________________________
  3.  
  4. EarthMap 0.59                                       --------------------------
  5.                                                      This program is FREEWARE
  6. Version date : 22 Jun 1993                          --------------------------
  7.                                                      (but *NOT* for education,
  8.                                                       see end of this guide)
  9. ----------------
  10. - Introduction -
  11. ----------------
  12.  
  13. EarthMap is an electronic globe. It enables you to wander over the earth using
  14. your mouse and keyboard. You can pan all around the globe, and zoom in or out,
  15. enabling examination of objects as large as the whole world down to every twist
  16. of a tiny river in some far away country.
  17.  
  18. EarthMap draws on a *massive* database of coordinate data. Unlike all other
  19. similar applications for the Archimedes, who have a database containing only
  20. several hundred thousands of coordinates, EarthMap's database consists of an
  21. enormous 5,719,617 line segments, which describe the earth in very fine detail.
  22.  
  23. Details are available on all major 'natural' features of the earth, like
  24. continent outlines, lakes, rivers, country boundaries, etc.. There is no data
  25. on cities and the like.
  26.  
  27. The database was not created by myself, pen, paper, ruler and charts in hand !
  28. The origin of the data is the 'CIA World Data Bank II data base', which is a
  29. database of 130Mb of COBOL records. It was compressed from COBOL records to a
  30. more compact representation (around 13Mb of data) by Brian Reid. The database
  31. itself has been put in the public domain by the US Government.
  32.  
  33. If you received !EarthMap without the coordinate data (which should be in the
  34. 'Maps' directory as 'africa_Map.bdy_cbd' etc.), you will have to find a way to
  35. obtain it. It is available by ftp from (among others) hanauma.stanford.edu
  36. (36.51.0.16), in pub/World_Map/Map.tar.Z.? (5 parts : glue, uncompress, untar
  37. and copy the _cbd files in !EarthMap.Maps). Another site that stores the data
  38. at the time of writing is gatekeeper.dec.com. Be prepared for a long, long
  39. download !
  40.  
  41. EarthMap can make do with any single data file, up to the whole set (i.e. it is
  42. possible to have only, say Europe 'on-line'). When EarthMap finds no data files
  43. at all, it will complain.
  44.  
  45. EarthMap enables you to look around, but it also enables you to save your
  46. examinations to Draw files for further processing, printing, etc..
  47.  
  48.  
  49. -------------------------
  50. - Using the application -
  51. -------------------------
  52.  
  53. To start up EarthMap, double-click on the '!EarthMap' icon.
  54.  
  55. It will install itself on the icon bar, and clicking MENU on EarthMap's icon
  56. pops up the main menu, giving the usual 'Info' and 'Quit' options, and others,
  57. which will be discussed further on.
  58.  
  59. - Viewing
  60.  
  61. Clicking on the iconbar icon will open the view window. The view window shows
  62. a flat projection of a selected piece of the earth.
  63.  
  64. The window always contains the entire worldmap, i.e. scrolling around you may
  65. reach all the edges of the world.
  66.  
  67. - Panning
  68.  
  69. Panning may be done by dragging the view window's scroll bars, or double-
  70. clicking on a point within the view window with SELECT or ADJUST, which will
  71. re-centre on this point.
  72.  
  73. - Zooming
  74.  
  75. Zooming in or out may be done by (single-)clicking on a point with SELECT or
  76. ADJUST respectively, while holding down the CTRL (factor 1.5), SHIFT (factor 2)
  77. or ALT (factor 4) key. This will also re-centre on this point.
  78.  
  79. Easier zooming may be accomplished by 'dragging' a box around the area of
  80. interest, by clicking SELECT or ADJUST on one corner, holding the button, and
  81. dragging the mouse to the opposite corner, then releasing the button.
  82.  
  83.  
  84. -----------------
  85. - The main menu -
  86. -----------------
  87.  
  88. This menu, popped up by clicking MENU on EarthMap's iconbar icon, contains a
  89. number of icons (some of which lead to submenu's/windows). The functions of the
  90. icons will be discussed below.
  91.  
  92. The main purpose of the main menu is to provide access to EarthMap's control
  93. window (via the 'Control' icon), which contains (in groups) most of the
  94. available options and controls.
  95.  
  96. -----------
  97. | Control |
  98. -----------
  99.  
  100. Gives access to EarthMap's control window, which contains most of EarthMap's
  101. options and controls, divided into groups.
  102.  
  103. Clicking on this icon will make this window permanent (but it can be closed
  104. again by clicking on its close icon).
  105.  
  106. Several types of icons appear in the control window :
  107.  
  108. - Toggle icons. These are square, and clicking on them switches the
  109.   corresponding option on (red square in its middle) or off ('closed' box).
  110. - Writable icons. These are square icons with a border and a white background,
  111.   in which you may click an subsequently enter a value or text.
  112. - Button icons. These are round, and clicking on them executes some function.
  113.   They do not change their appearance when clicked on.
  114. - 'Up/down' button icons. These are triangular, and increase or decrease some
  115.   value in the writable icon in between them. When clicking ADJUST instead of
  116.   SELECT or MENU, 'up' decreases and 'down' increases (i.e. reverse).
  117.  
  118. The functions of the icons in the control window are discussed below. Icons are
  119. identified by giving their 'path', i.e. group name (name on the border
  120. surrounding the group), if appropiate followed by sub-category (medium grey
  121. heading), followed by the icon's own name, seperated by '|'s.
  122.  
  123. \\\\\\\\\\\\\
  124.  Coordinates
  125. /////////////
  126.  
  127. This group enables you to enter longitude (-180 to +180 degrees) and latitude
  128. (-90 to +90 degrees) coordinates. The specified point on the earth can then
  129. be re-centered to.
  130.  
  131. Values for degrees, minutes and seconds may be entered in the appropiate
  132. writable icons. The 'up/down' buttons above/below a writable icon will
  133. increase/decrease the value by 1, when clicked with SELECT. The direction may
  134. be reversed by clicking ADJUST instead.
  135.  
  136. \\\\\\\\\\\\\\\\\\\\\
  137.  Coordinates | Go to
  138. /////////////////////
  139.  
  140. Clicking this button will pan over to the specified coordinates (which will
  141. be exactly at the centre of the window).
  142.  
  143. \\\\\\\\\\\\\\\\\\\
  144.  Coordinates | Get
  145. ///////////////////
  146.  
  147. Clicking this button will calculate the longitude/latitide coordinates at the
  148. exact middle of the view window, and will enter them in the corresponding
  149. writable icons.
  150.  
  151. \\\\\\\\\\\\\\\\\\\\\\\
  152.  Draw file | Page size  ***
  153. ///////////////////////
  154.  
  155. In these two writable icons, the page size on which the Draw file output is
  156. based may be specified, in inches. Default is A4 size (8.27" x 11.69").
  157.  
  158. Refer to 'Draw files' for details on how this affects the Draw file.
  159.  
  160.  
  161. ----------
  162. | Detail |
  163. ----------
  164.  
  165. Gives access to a window in which details shown may be switched on or off.
  166.  
  167. Clicking on this icon will make this window permanent (but it can be closed
  168. again by clicking on its close icon).
  169.  
  170. The 'features' in the database are listed in 4 groups (actually corresponding
  171. to one database file each, per continent). All details within the groups may be
  172. switched on or off individually.
  173.  
  174. Switching details off will speed up redrawing. It is recommended to switch off
  175. as much detail as possible while panning around the earth. Switching off whole
  176. groups is especially beneficial, as EarthMap can then completely skip the
  177. corresponding database files.
  178.  
  179. The colours of the details are shown in a small box in front of the toggle
  180. flags.
  181.  
  182.  
  183. --------
  184. | Save |
  185. --------
  186.  
  187. This icon leads to a save file window from which the Draw filetype icon may be
  188. dragged to a filer window, after entering the required Drawfile's leafname.
  189.  
  190. This will save the contents of the current view to a Draw file, which may then
  191. be processed, printed, etc., by applications accepting Draw files.
  192.  
  193. The resulting Draw file is fully WYSIWYG : details switched 'off' will not be
  194. saved to the Draw file.
  195.  
  196.  
  197. ----------
  198. | Status |
  199. ----------
  200.  
  201. This icon gives access to a submenu of status handling functions.
  202.  
  203. EarthMap's status consists of the items marked with ***, and the 'Detail'
  204. flags.
  205.  
  206. - Save
  207.  
  208. Clicking on this icon will save the current status in EarthMap's status file.
  209.  
  210. This file (when present) is always loaded on startup, or may be explicitly
  211. loaded by using the 'Load' option (to override the current status).
  212.  
  213. - Load
  214.  
  215. Clicking on this icon explicitly (re-)loads the status file, overriding the
  216. current status.
  217.  
  218. - Default
  219.  
  220. Clicking on this icon selects the default status settings.
  221.  
  222. - Kill
  223.  
  224. Clicking on this icon will remove the status file. 'Standard' defaults will
  225. be used when EarthMap is next started up.
  226.  
  227.  
  228. --------------
  229. - Draw files -
  230. --------------
  231.  
  232. EarthMap produces Draw files in the following way.
  233.  
  234. The 'window' used on the data is exactly what is seen in the on-screen display
  235. window. Remember this is a view on the entire worldmap. In other words, this
  236. means the display window specifies a longitude/latitude box, henceforth called
  237. 'the coordinate box'.
  238.  
  239. Line segments that fall inside the coordinate box will end up in the Draw file,
  240. but also any lines crossing the coordinate box boundaries (i.e. from inside the
  241. box to outside the box and vice versa).
  242.  
  243. The EarthMap data consists of long sequences of line segments, and while
  244. building up the Draw file these are *completely* followed. This means that a
  245. number of sequences crossing the coordinate box boundaries will usually have a
  246. number of line segments that lie completely outside the box. These line
  247. segments are ignored and not included in the Draw file. However, the line
  248. segments that cross a boundary of the coordinate box *are* included in the Draw
  249. file.
  250.  
  251. This has consequences for the Draw file bounding boxes. These will potentially
  252. grow bigger than the coordinate box itself, because they also have to enclose
  253. the coordinates of the end points of the lines crossing the coordinate box
  254. boundaries.
  255.  
  256. While building up the Draw file, EarthMap calculates path bounding boxes this
  257. way, and also calculates the 'global' bounding box, i.e. the box enclosing all
  258. the generated coordinate data. Note again that the global bounding box (which
  259. is also saved in the Draw file) is usually *bigger* than the coordinate box.
  260.  
  261. The page size which may be specified in the Control window, in turn, determines
  262. the coordinate *scaling* used. The coordinate scaling used is calculated such
  263. that the *coordinate* box fits exactly on the page specified (i.e. the image is
  264. scaled such that both sides would fit on the page, that is, one side would fit
  265. exactly, the other would have some space left, depending on the aspect ratios
  266. of the coordinate window and the page).
  267.  
  268. The important thing to realize is that the Draw file you end up with usually
  269. has a *bigger* bounding box than the page size specified.
  270.  
  271. Thus, on loading the Draw file, Draw will nearly always use the next bigger
  272. page size on loading the produced Draw file, i.e. when the page size set in the
  273. Control window was exactly A4, Draw will usually end up using A3 as its
  274. underlying page size.
  275.  
  276. Therefore, if you need to make an image fit *exactly* on, say, an A4 page,
  277. specify a *smaller* page size in the Control window to allow for the bigger
  278. global bounding box. How much smaller depends on how long the line segments
  279. crossing the coordinate box are. Experimentation is the key here.
  280.  
  281.  
  282. ----------------
  283. - Memory usage -
  284. ----------------
  285.  
  286. WorldMap runs in a minimum amount of memory when it is not processing anything.
  287. Before processing, as much memory as needed is grabbed, and released again
  288. afterwards.
  289.  
  290. Keep a few hundred K's free to enable WorldMap to run properly. When there is
  291. too little memory available, WorldMap will complain.
  292.  
  293.  
  294. -----------
  295. - The end -
  296. -----------
  297.  
  298. Outside educational environments, this application is Freeware, which means it
  299. may be copied freely, as long as it is not charged for and is copied completely
  300. and unchanged.
  301.  
  302. To be able to use it in an educational environment, registration is required.
  303. Contact me at the address given below for details of the costs involved, giving
  304. as much information about your school as possible (i.e. location, size, etc.).
  305. Registration includes the entire package, inclusive of the coordinate data, on
  306. 13 discs, and any updates to the software.
  307.  
  308. If you have praise, complaints, comments, bugs(!), or anything else to offer
  309. me, do not hesitate to write to
  310.  
  311. John Kortink
  312. Nutterbrink 31
  313. 7544 WJ Enschede
  314. The Netherlands
  315.  
  316. or try email to john@dialis.hacktic.nl.
  317.  
  318. New versions of the application are available from the same address : just send
  319. £1 to cover postage and a self-addressed envelope containing a formatted 3.5"
  320. disc.
  321.  
  322. NOTE : I will not provide the 13Mb of coordinate database (unless persuaded
  323. to do so by suitable sums of money :-).
  324.  
  325. Happy wandering !!!
  326.  
  327. _______________________________________________________________________________
  328.  
  329. !!! NOTE !!!
  330.  
  331. You may NOT change this application or use ANY part of it in other products
  332. without my approval. You may spread it freely (with *ALL* files included), but
  333. not for any profit. This software is provided 'as is'. Using it is entirely at
  334. your own risk.
  335.  
  336. _______________________________________________________________________________
  337.  
  338.